Power users hub/ru

---

Это место, куда можно прийти, если вы опытный пользователь и хотите узнать больше о настройке и расширении FreeCAD.

FreeCAD расширяем с помощью кода Python, который запускается непосредственно в консоли Python или загружается из модулей при запуске. Это означает, что вы можете модифицировать FreeCAD без необходимости перекомпиляции программы. Например, вы можете:

• Создавать и изменять геометрию: вы можете создать новый вид объекта, либо с нуля, либо адаптировав существующий тип.
• Создавать собственные инструменты и команды: создать ваши собственные наборы инструментов, запускающих Ваш код .
• Изменять интерфейс: создать панель инструментов и пометить туда ваши инструменты, создавать специальные окна, панели или интерфейсы для взаимодействия с вашими инструментами.
• Изменять представление в графе сцены: В FreeCAD есть разделение процессов построения и вычисления геометрии и отрисовки этой геометрии на вашем экране. У Вас есть полный доступ к способу отображения содержимого на экране, поэтому вы можете изменить представление, взаимодействовать с ним, или добавить к ним пользовательское поведение.

Вы можете так же добавить пользовательские экранные виджеты, как например информационные, перетаскиватели (draggers), якоря (привязки) или временные объекты (для быстрого предпросмотра операции).

Если Вы хотите добавить контент на эти страницы, запросите аккаунт на wiki с правом редактирования на форуме, изучите WikiPages насчёт общих рекомендаций, которым Вы должны следовать. Относительно прочих путей внести вклад в проект смотрите страницу о том как помочь FreeCAD.

Настройка FreeCAD

• Настройка Интерфейса: Начиная с начала: Панели инструментов и ярлыки
• Работа с макросами: Легкая запись часто повторяющихся задач или python кода
• Рецепты макросов
• Кастомизация панелей инструментов
• Установка дополнительных верстаков

Написание сценариев FreeCAD

Основы

Модули

Функциональность FreeCAD разделена между модулями, работающими со своими типами данных и приложениями. У FreeCADа есть встроенные модули и модули расширения (plug-ins). Когда модули расширений установлены, они становятся доступны вам как встроенные модули. Описываемые ниже модули модули по умолчанию, включённые в любую установку FreeCAD.

• Встроенные модули это принципиальные модули FreeCAD. Они содержат инструменты для манипулирования общими конфигурациями FreeCAD, документами и их содержимым.
• Создание верстаков покажет Вам как создать собственных верстак.

Работа с полигональными сетками

• Написание сценариев для Mesh: Как взаимодействовать с модулем Mesh

Работа с Parts

Получение доступа к визуализатору сцен - Coin

• The Coin/Inventor scenegraph: Как работает представление сцен в FreeCAD
• Pivy: Как получить доступ и изменить графическое представление сцены

Управление Qt интерфейсом

• PySide: Как получить доступ к интерфейсу и изменить его содержание
• Использование FreeCAD GUI в различных Qt приложениях с помощью PyQt

Работа с параметрическими объектами

Примеры

• Фрагменты кода: Коллекция фрагментов FreeCAD python кода, в качестве ингредиентов ваших сценариев...
• Функция отрисовки линии: Как собрать простой инструмент для отрисовки линий
• Создание диалога: Как сконструировать диалог в Qt designer, и использовать его в FreeCAD
• Встраивание FreeCAD: Как импортировать FreeCAD в виде python модуля в другие приложения
• Верстак черчениядобавляет основные функции 2d рисования в freecad. Он полностью написан на python, так что может быть хорошим примером если вы хотите писать ваши собственные модули.
• Векторная библиотека FreeCAD: Пара полезных функций для работы с векторами в FreeCAD. Эта библиотека также включена в Чертежный Модуль.

Функции API

Полное описание API можно найти в http://www.freecad.org/api/ . Он содержит программный интерфейс как на C++, так и на Python, и пока не совсем хорошо форматирован, что может мешать при просмотре кода Python. Более простая для просмотра версия доступна здесь. Заметим что он может быть неполным, так как обновляется вручную. Для получения более точной информации, просматривайте модули напрямую из консоли Python FreeCADа.

Связанное: Представление C++ в Python

Продвинутые модификации

• Запуск и настройка: Запуск и параметры командной строки
• Установка в Windows: Использование установщика windows
• Компиляция FreeCAD в Windows и компиляция FreeCAD в Linux
• Маркирование: Простые изменения, которые вы можете сделать с исходными кодами для изменения некоторых аспектов FreeCAD
• Дополнительные модули Python : Расширение интерпретатора python в FreeCAD этими мощными модулями!

Учебники по Python

Здесь представлены хорошие общие учебники, без специфики FreeCAD, они могут вас заинтересовать, если для вас python, это что-то свовершенно новое.

Python

• Официальный учебник python - весьма полный учебник для знакомства с Python
• Учебник по python для не программистов - отличная wikiкнига
• Python для новичков - один большой учебник, полностью охватывающий основы

Дальнейшие два ссылаются на специффичные для PyQt (не PySide), но могут предложить некоторую полезную информацию:

• Basic PyQt tutorial : Простое и короткое, ориентированное на linux руководство, объясняющее работу с PyQt и Qt Designer
• Programming Qt applications in python : Более глубокое руководство, описывающее все процессы работы с qt и python.

Pivy - Как взаимодействовать с в 3D сценой FreeCADа

• Pivy - Embedding a Dynamic Scripting Language into a Scene Graph Library : Тезис, подробно объясняющий Pivy
• High Level 3D Graphics Programming in Python : Примеры Pivy из Pycon 2004
• Introducing Pivy into studierstube (Mirror) : Документ, который на самом деле не учебник, но прекрасно иллюстрирует как работает Pivy (требует академический аккаунт)

Проекты сообщества

На портале Сообщества, вы можете найти другие основанные на FreeCAD проекты запущенные сообществом пользователей FreeCAD. Если вы начинаете новый проект FreeCAD, убедитесь что его нет в списке! У нас также есть страница, с описанием вещей, которые вы могли бы сделать, если хотите Помочь FreeCAD.